%format latexg
%
%
%                      CS-TeX 4.0 f�r den Atari ST
%                      ===========================
%
%  Dies ist die Dokumentation zu CS-TeX 4.0
%  Stand: 04.05.92
%
%  Diese Dokumentation ist in TeX geschrieben, kann aber gegebenenfalls
%  auch direkt als Text gelesen werden.
%
%  Hinweis: Das Inhaltsverzeichnis ist erst nach dem 2. TeX-Lauf korrekt !
%
%  Copyright (c) 1990,91,92 Christoph Strunk
%
%  !!!! An diesem Text d�rfen Sie keine Ver�nderungen vornehmen !!!!
%
%%%%%%%%%%%%%%%%% Einige Sachen f�r TeX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\newcommand{\revisiondate}{Stand: 4.~Mai 1992}

\documentstyle[din_a4,german]{article}

\oddsidemargin 0pt \evensidemargin 0pt
\parskip 5pt plus 2pt minus 2pt \parindent 0pt
\topsep 0pt \partopsep 0pt
\topmargin 0cm \topskip 0pt
\pagestyle{headings}

% Die folgede Definition eines Uppercase-Es-zett ist nur
% in dieser Dokumentation sinnvoll:
\catcode`�=\active \def�{SS}

% Nette logos
\font\logo=logo10
\def\MetaFont{{\logo METAFONT}}
\def\zpcad{{\tt ZPCAD}}
\def\Format{{\tt\%format}}
\def\co{\leavevmode\raise.3ex\hbox{c}/o} % c/o

% Jetzt wird's ein wenig trickreich
\makeatletter
\def\Datei{\begingroup \tt \catcode`\_=11 \catcode`\\=11 \D@tei}
\def\D@tei#1{#1\endgroup}
\makeatother

% Geklaut aus tripman.tex (vergleiche auch \TeXbook, Anhang B.3):
\def\listing#1{\par \begingroup \frenchspacing
  \def\do##1{\catcode`##1=12 } \dospecials
  \parskip 0pt \parindent 1.5cm
  \catcode`\ =\active \catcode`\^^M=\active
  \tt \def\par{\ \endgraf} \obeylines \obeyspaces 
  \input #1 \endgroup}
% a blank line will be typeset at the end of the file;
% if you're unlucky it will appear on a page by itself!
{\obeyspaces\global\let =\ }

\begin{document}

%%%%%%%%%%%%%%%%% Titelseite %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\thispagestyle{empty}
%
\begin{center}{\LARGE\bf
%
             CS-\TeX\ 4.0 f�r den Atari ST/TT                }\\[1cm]
%
                           von                                \\[0.7cm]
%
                    Christoph Strunk                          \\
                    Wartburgstr. 10                           \\
                D-W-4630 Bochum 7
\end{center}
%
\vspace*{1cm}
\begin{center}\revisiondate\end{center}
\vfill
%
%
%%%%%%%%%%%% Inhaltsverzeichnis %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%  Hinweis: Das Inhaltsverzeichnis ist erst nach dem 2. TeX-Lauf korrekt !
%
\tableofcontents\newpage
%
%%%%%%%%%%%% Kapitel 1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\section[Einf�hrung]{Einf�hrung}

\TeX\ (sprich Tech, von griechisch tau, epsilon, chi) ist ein
Textsatzprogramm, das von Donald~E.\ Knuth in Stanford entwickelt wurde.
\TeX\ ist kein normales Textverarbeitungsprogramm und will auch nicht
mit der Schreibmaschine konkurrieren. \TeX\ ist ein Satzprogramm
und tritt damit in Konkurrenz zum Buchsatz. Besonders geeignet ist es
f�r den Satz mathematischer Texte mit vielen Formeln und Tabellen.
Zum \TeX-System geh�rt auch \MetaFont, der Font-Generator zu \TeX.

Dieser Text ist keine Anleitung zu \TeX. Um \TeX{} benutzen zu k�nnen, ist
eine Anleitung aber unerl��lich. Wollen Sie, was vermutlich sinnvoll ist,
\TeX{} mit dem MacroPaket \LaTeX{} benutzen, so brauchen Sie auf jeden
Fall eine Anleitung, die speziell auf \LaTeX{} eingeht.

Eine kurze Dokumentation zu \LaTeX{} ist im Lieferumfang enthalten. Wenn
Sie von Disk~2 das Archiv \Datei{LKURZ} installiert haben, finden Sie im
Ordner \Datei{LKURZ} eine \LaTeX-Kurzbeschreibung, die f�r den Einstieg
in \LaTeX{} ausreichend ist. Wer sich ernsthaft mit \TeX{} besch�ftigen
will, mu� aber fr�her oder sp�ter auf die Literatur zur�ckgreifen.
Sehr gut geeignet ist z.\,B.\ das folgende Buch:

\begin{quote}
      Helmut Kopka: LaTeX - eine Einf�hrung. Addison Wesley 1988.
\end{quote}

Mittlerweile gibt es auch einen Vertiefungsband:

\begin{quote}
      Helmut Kopka: LaTeX - Erweiterungsm�glichkeiten. Addison Wesley 1990.
\end{quote}

Wer die Original-Dokumentation zu \TeX{} (allerdings ohne \LaTeX) haben
m�chte und die englische Sprache nicht scheut, mu� sich an das folgende
Buch halten:

\begin{quote}
      Donald E. Knuth: The TeXbook. Addison Wesley 1989.
\end{quote}

Da in den B�chern die Besonderheiten der einzelnen Portierungen keine
Beachtung finden k�nnen, beschreibt der folgende Text nun ausschlie�lich
die Besonderheiten dieser Portierung f�r den Atari ST.

%
%%%%%%%%%%%% Das Atari-TeX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\section{Das CS-\protect\TeX{} 4.0}

Die Implementierung CS-\TeX~4.0 ist kein Public Domain Programm, sondern
FreeWare, d.\,h., ich behalte mir das Copyright vor, erlaube aber die freie
Benutzung und Weitergabe, solange die weiter unten genannten Auf"|lagen
gewahrt bleiben. Insbesondere darf das System nur v�llig kostenlos
weitergegeben werden; der Vertrieb via PD-Versand ist verboten.

CS-\TeX~4.0 ist ein Nachfolger des Public Domain Atari\TeX~2.00 und basiert
auf der \TeX-Version 3.141 // 2.6cs, die zu der bisherigen Version 3.1 // 2.1cs
voll abw�rtskompatibel ist.

Eine weitere \TeX-Version verkaufe ich unter dem Namen Multi\TeX~5.0 �ber
die MAXON Computer GmbH als Sonderdisks (zum Preis von derzeit 75~DM;
mu� von jedem Benutzer/jeder Benutzerin einzeln k�uf"|lich erworben werden).
Dieses Paket enth�lt unter anderem eine v�llig neue Shell, die die
bisherige \TeX- und \MetaFont-Shell ersetzt, s�mtliche Systemteile mit
einer sauberen GEM-Einbindung begl�ckt und speziell an die
Multitasking-Systeme MultiGEM und MiNT/MultiTOS
(demn�chst auch MagiX alias Mag!X)
angepa�t wurde -- aber auch ohne MultiGEM ist sie deutlich
komfortabler als \verb|CTEX| und \verb|C_MF|. Ferner enth�lt das Paket ein
\MetaFont{} mit Online-Grafik-Ausgabe. Dies ist beim Design eigener
\TeX-Fonts eine gro�e Hilfe. Auch spezielle Versionen f�r Atari~TT mit
68882-Unterst�tzung sind bei Multi\TeX~5.0 dabei.

\subsection{Bezugsquelle}

\begin{samepage}
Das komplette CS-\TeX~4.0 inclusive \MetaFont\ f�r den Atari~ST k�nnen Sie
bei der "`Deutschsprachigen Anwendervereinigung \TeX"' bekommen:

\begin{quote}
  DANTE e. V.\\
  Postfach 10\,18\,40\\
  D-W-6900 Heidelberg 1
\end{quote}
\end{samepage}

Zur ersten Kontaktaufnahme fordern Sie bitte mit einem frankierten R�ckumschlag
Informationsmaterial an.
Wer Zugang zum Internet hat, kann das System auch beim FTP-Server in Stuttgart:
\begin{verbatim}
  rusmv1.rus.uni-stuttgart.de [129.69.1.12]
\end{verbatim}
im Verzeichnis \verb|/soft/tex/machines/atari/cstex-4.00| (oder so �hnlich)
finden.

Das Multi\TeX~5.0 bekommen Sie bei:

\nopagebreak
\begin{quote}
  MAXON Computer GmbH\\
  -- Sonderdisks --\\
  Schwalbacher Str. 52\\
  Postfach 5969\\
  D-W-6236 Eschborn
\end{quote}

\subsection{Copyright}

Die hier beschriebene \TeX-Version ist (im Gegensatz zu anderen)
FreeWare, d.\,h., ich behalte mir das Copyright vor, erlaube jedoch die
freie Benutzung und Weitergabe, solange die folgenden Auf"-lagen gewahrt
bleiben:

Das System darf nur v�llig kostenlos weitergegeben werden; insbesondere ist
der Vertrieb via PD-Versand verboten. Einzige Ausnahme: DANTE e.\,V.\ darf
das Paket zum Selbstkostenpreis vertreiben. Die Programme d�rfen nur
unver�ndert und mit vollst�ndiger Dokumentation weitergeben werden.

Die nachfolgend aufgef�hrten Zugaben geh�ren nicht unmittelbar zum
\TeX-Paket und haben abweichende Copyright-Bestimmungen, die sie der
jeweils beigef�gten Dokumentation entnehmen k�nnen:
Der MicroEMACS-Editor, der \verb|xEdit| GEM-Editor (ShareWare),
die M-Disk und die \verb|LHARC|-Versionen.

\subsection{Haftungsausschlu�}

Ich benutze dieses Programm viel und habe bisher noch keine Fehler
feststellen k�nnen. Um unvern�nftigen Leuten aber keine falschen
Illusionen zu machen, mu� ich auf das Folgende aufmerksam machen:

{\bf
ACHTUNG. Diese Software ist ohne jede Garantie. Ich verspreche keine
Wartung und �bernehme keine Verantwortung f�r Sch�den, die durch die
Benutzung dieses Programmes entstehen. Jegliche Ersatzanspr�che lehne
ich ab.
}

\subsection{Systemvoraussetzungen}

Zum Betrieb des CS-\TeX~4.0 brauchen Sie einen Atari~ST, ST$^E$ oder~TT
mit mindestens 1~MB~RAM (besser mehr). Das CS-\TeX~4.0 funktioniert
problemlos mit allen bekannten Atari-Hardware-Kon"-figurationen,
insbesondere also auch mit Speed-Boards, Gro�bildschirmen, beliebigen
Grafikkarten, Schwarz"-wei�- und Farbmonitoren, usw.

CS-\TeX~4.0 funktioniert auf allen bekannten TOS-Versionen ab 1986.
Es ist jedoch sinnvoll, mindestens die Version~1.4 von 1989 zu
benutzen, da diese erheblich weniger Fehler hat und auf Festplatten
sehr viel schneller zugreifen kann als die Vorg�ngerversionen.
Falls Sie eine �ltere TOS-Version haben, k�nnen Sie sich auch noch
nachtr�glich die aktuelle TOS-Version von Ihrem H�ndler einbauen
lassen. Die derzeit (Februar~1992) aktuelle Version hat die
Nummer~2.06 und kostet ohne Einbau etwa 200~DM.

Zum Betrieb brauchen Sie eine Festplatte mit mindestens 5~MB freiem Platz
f�r \TeX{} -- ich empfehle Ihnen, \TeX{} auf einer eigenen Partition
von ca.~15~MB unterzubringen. Der Betrieb ohne Festplatte wird nicht
unterst�tzt.

\subsection[Systemkomponenten]{Die Komponenten des Systems}

Das CS-\TeX~4.00 vom Mai~1992 besteht aus:

\begin{itemize}
\item Einer Implementierung von Donald~E.\ Knuth's \TeX\ 3.141 (da
      "`\TeX\ 3.0"' aber inzwischen schon zu einem festen Begriff geworden ist,
      wird hier gelegentlich noch von \TeX\ 3.0 als Oberbegriff f�r alle
      Versionen mit einer 3 vor dem Komma geredet) in der
      Atari-Version 2.6cs. Dies ist das Herz des Systems.
\item Einer grafischen Shell \Datei{CTEX.PRG}, mit der das ganze \TeX-System
      intuitiv per Maus oder Tastatur gesteuert werden kann.
\item Diversen Eingabe-Dateien f�r Ini\TeX, wie PLAIN \TeX, \LaTeX,
      deutsche und englische Trennmuster, usw.
\item Diversen Eingabe-Dateien f�r \TeX, Beispiel-Texten usw.
\item Einer Familie von Druckertreibern (DVI-Treiber) f�r alle g�ngigen
      Drucker. Bei den Treibern ist eine gesonderte Dokumentation, die auch
      die Grafikf�higkeiten beschreibt.
\item Einem automatischen Installationsprogramm, welches das System per
      Knopfdruck komplett installiert.
\item Einem kleinen Satz von g�ngigen Fonts (Zeichens�tzen). Weitere Fonts
      kann jede(r) BenutzerIn selber mit \MetaFont\ erstellen.
\item Diversen Hilfsprogrammen.
\end{itemize}

Es wird zusammen mit \MetaFont{} ausgeliefert.
Dieses besteht aus:

\begin{itemize}
\item Einer Implementierung von Donald~E.\ Knuth's \MetaFont~2.7 in der
      Atari-Version~2.5cs.
\item Einer grafischen Shell \Datei{C_MF.PRG}, mit der \MetaFont\ intuitiv
      per Maus oder Tastatur gesteuert werden kann.
\item Diversen Eingabe-Dateien f�r \MetaFont.
\item Diversen Hilfsprogrammen.
\end{itemize}

Ferner wird als Zugabe mitgeliefert:

\begin{itemize}
\item Eine Version des MicroEMACS Editors. Durch den mitgelieferten Editor
      ist das System in sich abgeschlossen. Allerdings steht zu vermuten,
      da� der Editor noch etliche kleinere oder gr��ere Fehler enth�lt.
\item Eine Version des \verb|xEdit| GEM-Editors, der speziell an \TeX{}
      angepa�t ist. Ein herzliches Dankesch�n geht an Alexander Gr�pl, der mir
      die Erlaubnis gegeben hat, den Editor hier beizulegen. \verb|xEdit| ist
      ShareWare -- bitte beachten Sie die entsprechende Dokumentation.
\item Eine Version der M-Disk. Dies ist ein n�tzliches Utility, besonders
      bei allen Aktionen, die Daten zwischen Festplatte und Diskette bewegen,
      also auch bei der Installation von Software und bei Backups.
\item Zwei Versionen des \Datei{LHARC} Archivierungs-Programms.
\end{itemize}

F�r die Zugaben gelten besondere Copyright-Bedingungen, die Sie aus den
jeweiligen Dokumentationen entnehmen k�nnen.

Die Version 3.141~//~2.6cs wurde im April~1992 erstellt und verifiziert.

Die \TeX-Portierung erfolgte mit dem GNU C Compiler Version~1.40. Die
Version ist damit doppelt so schnell wie die (ur-)alte Pascal-Variante
2.98~//~1.4cs.

Die Drucker- und Bildschirmtreiber wurden mit Lattice~C Version~5.06.01
�bersetzt.

%%%%%%%%%%%% Arbeitsweise %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Die grunds�tzliche Arbeitsweise von \TeX}

\TeX\ ist -- im Gegensatz zu Textverarbeitungen wie \Datei{SIGNUM} oder
DTP-Programmen wie \Datei{CALAMUS} -- kein WYSIWYG-Programm (WYSIWYG =
What you see is what you get). Dies bedeutet, da� Sie bei der Eingabe
am Bildschirm nicht sehen k�nnen, wie das Ergebnis sp�ter aussieht. Vor dem
Ausdrucken k�nnen Sie sich das Ergebnis allerdings mit dem sogenannten
Previewer am Bildschirm anschauen.

Der Nachteil bei WYSIWYG-Programmen ist, da� das Layout weitgehend von Hand
vorgenommen werden mu�. Das f�hrt bei Personen, die keine Buchsetzer-Lehre
absolviert haben, meist zu h��lichen bzw.\ typografisch falschen Layouts.
\TeX\ dagegen rechnet z.\,B.\ den optimalen Zeilenumbruch f�r jeden Absatz
einzeln aus. Das Layout sieht einfach besser als ein handgestricktes aus.

Dieser Vorteil wird allerdings mit dem Nachteil erkauft, da� man zwischen
Text-Eingabe und -Anschauen auf dem Bildschirm immer einen \TeX-Lauf
einschieben mu�.

\subsection{Eine Beispielsitzung}

Nehmen wir an, Sie haben Ihren Computer eingeschaltet, \TeX\ installiert,
und wollen nun damit arbeiten. Gehen Sie z.\,B.\ wie folgt vor:

\begin{enumerate}
\item Starten Sie \Datei{CTEX}. Lassen Sie alle Einstellungen so, wie sie sind,
      bis auf die folgenden: Stellen Sie unter "`Finden:HauptDatei"' den
      Namen ein, unter dem Sie Ihren Text speichern wollen.
\item Stellen Sie eventuell unter "`Finden:Editor"' den Editor ein, den Sie
      benutzen wollen. Tun Sie das nicht, so ist der MicroEMACS voreingestellt.
\item Dr�"cken Sie 'E'. Nun sind Sie im Editor und k�nnen Ihren Text
      eingeben. Tip: Kopieren Sie sich einen der Beispieltexte, lassen
      Sie den Text-Rahmen unver�ndert und ersetzen Sie nur den Text durch
      Ihren eigenen. Vergessen Sie nicht die "`\Format"'-Zeile.
      Verlassen Sie den Editor; Ihr Text ist jetzt eingegeben.
\item Falls \TeX\ jetzt nicht automatisch startet, dr�cken Sie 'T'.
      \TeX\ setzt nun Ihren Text, und speichert das Ergebnis in einer
      ger�teunabh�ngigen Form als \Datei{DVI}-Datei ab. Eventuell erzeugt
      \TeX\ auch noch weitere Dateien (automatisches Inhaltsverzeichnis usw.),
      die es dann selber im n�chsten Lauf wieder braucht. Das automatische
      Inhaltsverzeichnis sieht man daher erst nach dem zweiten \TeX-Lauf.

      Wie Sie bei Fehlern im \TeX-Lauf vorgehen, erfahren Sie in der
      Datei \Datei{FEHLER.TXT}.
      Wir nehmen nun an, da� \TeX\ fehlerfrei gelaufen ist.

\item Falls der Previewer jetzt nicht automatisch startet, dr�cken Sie 'V'.
      Nun sehen Sie das Ergebnis am Bildschirm. Dr�"cken Sie die
      "`Help"'-Taste, um weitere Hilfestellung zu erhalten.

      Nachdem Sie genug gesehen haben verlassen Sie den Previewer.

\item Sie k�nnen das Ergebnis jetzt ausdrucken. Dazu sollten Sie einen
      Druckertreiber einstellen (4~sind gleichzeitig einstellbar), und
      die zugeh�rigen Zusatzparameter nach Geschmack einstellen.
      F�r den Anfang gen�gt es, die Zeile mit den Zusatzparametern
      leer zu lassen. Nun k�nnen Sie drucken.

      Wenn Sie bis hierher gekommen sind, sollten Sie nun erst einmal
      \Datei{DVI_DOC.DVI}, die Dokumentation zu den Druckern am Bildschirm
      ansehen, ausdrucken und lesen. Wie das geht, steht in der Datei
      \Datei{DVI_INFO}.
\end{enumerate}

\subsection{Verfahren bei langen Texten}

Wer lange Texte bearbeiten will, m�chte nat�rlich nicht jedesmal darauf
warten, da� der ganze Text in \TeX\ durchlaufen wird, um dann endlich
den Fehler ganz am Ende zu finden. Daher ist es sinnvoll, den Text in
verschiedene Abschnitte aufzuteilen.

Dabei wird eine Hauptdatei �hnlich der folgenden erstellt:

\begin{verbatim}
     %format latexg
     \documentstyle[din_a4,german]{article}
     \pagestyle{empty}
     % usw. ...
     \begin{document}
     % \input titelseite.tex    % Die Titel-Seite
     % \tableofcontents         % Das Inhaltsverzeichnis
     % \input kapitel1.tex      % Das 1. Kapitel
       \input kapitel2.tex      % Das 2. Kapitel  (gerade in Arbeit)
     % \input kapitel3.tex      % Das 3. Kapitel
     % \input kapitel4.tex      % Das 4. Kapitel
     % usw. ...
     \end{document}
\end{verbatim}

Diese Datei wird dann in \Datei{CTEX} als HauptDatei eingestellt.
ArbeitsDatei ist jeweils ein Kapitel, welches dann gleichzeitig
in der HauptDatei auskommentiert ist. Auf diese Weise wird immer nur
ein Kapitel ediert und von \TeX\ abgearbeitet.

Hat man alles fertig, so macht man einen letzten Lauf, in dem man
alle Kapitel aktiviert, und dann soviele \TeX-L�ufe macht,
bis das Inhaltsverzeichnis stimmt. Anschlie�end kann der Text
ausgedruckt werden.

%%%%%%%%%%%% Besonderheiten %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section[Besonderheiten]{Besonderheiten dieser Installation}

Alle \TeX-Implementationen sind mehr oder weniger gleich. CS-\TeX~4.0
kann aber einiges, was Sie nicht �berall finden. Einige �nderungen, durch
die das PD-\TeX{} in einigen Punkten vom �blichen Standard abwich, wurden
ab August~1991 wieder r�ckg�ngig gemacht. In Zukunft werde ich mich bem�hen,
alle offiziellen Standards einzuhalten.

\subsection{Die \protect\Format-Zeile}

\Datei{CTEX} (nicht \TeX) wertet eine \Format-Zeile am Anfang der
Hauptdatei aus. Dadurch mu� man sich nicht mehr selber merken, welches
Format die einzelnen \TeX\ Dateien brauchen. Wenn Sie Beispiele aus B�chern
oder andere Texte mit CS-\TeX\ bearbeiten wollen, empfiehlt es sich,
vor der ersten Zeile der HauptDatei eine \Format-Zeile einzuf�gen.

Die \Format-Zeile beginnt mit `\Format', dann folgt der
Name des Formates, das f�r diese Datei gebraucht wird. Bei \Datei{LATEXG},
dem deutschen \LaTeX\ ('G' steht f�r 'german'), hat die Zeile das Aussehen:

\begin{verbatim}
        %format latexg
\end{verbatim}

wobei vor dem `{\tt\%}' keine Leerzeichen stehen. % (siehe oben !)

\subsection{Dateinamen}

Da \TeX\ und \MetaFont\ den Backslash `\verb|\|' als Sonderzeichen
interpretieren, mu� in File-Namen hier ein Slash '\verb|/|' eingegeben werden.
Beispiel: `\Datei{\input a:/ich/du}' liest die Datei `\Datei{a:\ich\du.tex}'.

\TeX\ und Ini\TeX\ suchen Ihre Eingaben evtl.\ in mehreren Ordnern.
Dies wird durch Environment-Variablen gesteuert. Wie die hei�en
und was die Standard-Belegung ist, kann man in \Datei{CTEX} sehen.

\TeX\ sucht seine Eingaben auch da, wo es seine Ausgaben schreibt.
Daher k�nnen die Ausgabe-Files (\LaTeX\ `\Datei{.AUX}' etc.) auch
beim Einlesen wieder gefunden weden.

Neu ab \TeX/\MetaFont\ Version \verb|x.y // 1.7cs|: Die Suchpfade f�r
die Eingaben k�nnen jetzt
mit einer Besonderheit ausgestattet werden: Wird an einen Ordnernamen
ein '\verb|/*|' (oder '\verb|\*|') angeh�ngt, so sucht \TeX\ die Dateien nicht
nur in dem angegebenen Ordner, sondern auch in dessen Unter-Ordnern und
wiederum deren Unter-Ordnern usw.; der Teilbaum wird allerdings nur bis
zur Tiefe von drei Ordner-Ebenen durchsucht. Dies erlaubt eine bessere
Sortierung der Eingabe-Dateien bei gleichzeitig k�rzeren Suchpfaden.

\subsection{Font-Auswahl}

Derzeit werden zwei Versionen von `\Datei{lfonts.tex}' mitgeliefert:
`\Datei{lfonts.std}' ist die Standard-Version und `\Datei{lfonts.mag}'
ist eine von mir leicht bearbeitete Version. Stellen Sie die Version,
die Sie lieber m�gen, in `\Datei{lfonts.tex}' ein und erzeugen Sie danach
die \Datei{LATEX} und \Datei{LATEXG} Formate neu.

Einige Fonts wurden im Laufe der Zeit umbenannt. Wenn Ihnen also \Datei{PK}
oder \Datei{TFM} files fehlen, suchen Sie nach den folgenden �quivalenten:

\begin{verbatim}
                 circle10  = lcircle10
                 circlew10 = lcirclew10
                 manual    = manfnt
\end{verbatim}

\subsection{Ligaturen}

Bei den Ligaturen gibt es ab sofort keine Besonderheiten mehr.
Falls Sie aus der Installation von fr�heren Versionen im Ordner
\verb|\METAFONT\INPUTS\ATARI| noch die Dateien \verb|ATARI.DOC|,
\verb|ITALIG.MF| und \verb|ROMLIG.MF| haben, so l�schen Sie diese
bitte umgehend. Danke.

\subsection{Grafik}

Das Atari-\TeX\ bietet umfangreiche M�glichkeiten zur Einbindung von
Vektor- und Rastergrafik.
Dokumentation und Beispiele zur Grafik-Einbindung finden Sie im Ordner
`\Datei{BILDER}' und in der Beschreibung der Druckertreiber
(\Datei{DVI_DOC.DVI}).

\Datei{DVI_DOC.DVI} enth�lt auch noch viele weitere n�tzliche Informationen,
die hier nicht alle wiederholt werden sollen.

Die Vektorgrafik des CS-\TeX\ (CSG) eignet sich besonders gut f�r die Ausgabe
aus eigenen Programmen. Wer jedoch ein Programm sucht, mit dem eine Zeichnung
'mal schnell von Hand entworfen weden kann, dem seien die Public Domain
Programme \TeX draw (PD ST-389) und \zpcad\ (PD ST-398 und~399) empfohlen.

\subsection{Sonderzeichen und die "`Cork-Tabelle"'}

Alle Zeichen incl.\ Control-Z sind in Eingabe-Dateien erlaubt;
CR allerdings nur vor oder nach LF. Der Code mu� sonst mit drei Zeichen
`\verb|^|\verb|^|\verb|M|' eingegeben werden. Die Zeichen mit
\verb|\catcode|~15 rufen nat�rlich Fehlermeldungen hervor
(siehe \TeX book, Kapitel 7).

\pagebreak[2]
Auf ihrer Tagung in Cork 1990 hat die TUG (= \TeX\ Users Group) eine Codierung
f�r die Sonderzeichen in den Fonts festgelegt. Die oberen 128 davon sehen
wie folgt aus:

\nopagebreak
\smallskip
\nopagebreak
\begin{center}
\renewcommand{\arraystretch}{1.6}
\begin{tabular}{*{17}{c|}}
         & \tt 0 & \tt 1 & \tt 2 & \tt 3 & \tt 4 & \tt 5 & \tt 6 & \tt 7
         & \tt 8 & \tt 9 & \tt A & \tt B & \tt C & \tt D & \tt E & \tt F \\
\hline
\tt 0x80 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0x90 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xA0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xB0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xC0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xD0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xE0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xF0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\end{tabular}
\renewcommand{\arraystretch}{1}
\end{center}

\smallskip
Diese Codierung bezieht sich jedoch nur auf die Fonts, ein Code f�r die
Daten-Eingabe wurde nicht festgelegt !!!
Ab Version 3.1 // 2.0cs k�nnen nun alle diese Zeichen direkt als
je ein einzelnes Zeichen eingegeben werden.

Klar ist aber, da� der Cork-Code auf dem Atari~ST als {\em Eingabe\/}-Code
unbrauchbar ist, da z.\,B.\ das es-zet `�' auf dem Atari nicht als {\tt 0xFF}
sondern als {\tt 0x9E} codiert ist. Daher mu� irgendwo eine Umcodierung
vorgenommen werden.

Beim CS-\TeX\ geschieht das gleich beim Einlesen aller Informationen aus
Dateien oder von der Tastatur, so da� der Benutzer nur den Atari-Code, \TeX\
jedoch nur den Cork-Code sieht.

Dummerweise sind auf dem Atari einige Zeichen der Cork-Tabelle gar nicht im
Standard-Zeichensatz enthalten. F�r diese Zeichen mu� sich jeder
\TeX-Implementierer eigene Codes �berlegen. Was bei mir dabei herausgekommen
ist, steht in der folgenden Tabelle der \TeX-Eingabe-Codes:

\smallskip
\begin{center}
\renewcommand{\arraystretch}{1.6}
\begin{tabular}{*{17}{c|}}
         & \tt 0 & \tt 1 & \tt 2 & \tt 3 & \tt 4 & \tt 5 & \tt 6 & \tt 7
         & \tt 8 & \tt 9 & \tt A & \tt B & \tt C & \tt D & \tt E & \tt F \\
\hline
\tt 0x80 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0x90 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xA0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xB0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xC0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xD0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xE0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xF0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\end{tabular}
\renewcommand{\arraystretch}{1}
\end{center}

\smallskip
Wie gesagt, sind auf dem Atari einige Zeichen der Cork-Tabelle gar nicht im
Standard-Zeichensatz enthalten. Die Festlegung eines Eingabe-Codes l�st dieses
Problem nur zur H�lfte, denn man m�chte ja auch gerne im Editor sehen,
was man gerade so eingibt.

Daf�r gibt es nun das Hilfsprogramm `\Datei{FONT.PRG}'. Wird es aufgerufen,
so installiert das Programm die Datei `\Datei{FONT}' als neuen 
8x16--System-Font in der hohen Auf"-l�sung des ST.
Leider gibt es einige Programme (Gulam usw.), die den Font rauswerfen
und wieder den ROM-Zeichensatz installieren. Bei Tempus sieht man den neu
installierten Zeichensatz erst dann, wenn man 'Systemzeichensatz' angeclickt
hat.
Im mitgelieferten Editor `\Datei{ME.TTP}' sehen Sie alles wie erwartet.
Zur Eingabe der Sonderzeichen k�nnen Sie sich hier selber Tastenkombinationen
definieren.

`\Datei{FONT.PRG}' ist kein weltbewegendes Programm. Wenn Sie etwas besseres
haben, und das der Allgemeinheit zur Verf�gung stellen wollen,
lassen Sie es mich wissen.

\subsection{Die {\protect\tt GEM}-Shells}

Die Bedienung des \TeX-Systems kann �ber die \Datei{CTEX} Shell, die
Bedienung von \MetaFont\ �ber \Datei{C_MF} erfolgen. Die Shells sind
so programmiert, da� Sie ohne weitere Anleitung damit zurechtkommen
sollten.

Beachten Sie aber bitte, da� nicht alle Zusatzparameter f�r die Drucker
mit der Maus einzustellen sind. Das Drucken von drei Kopien pro Seite
kann z.\,B.\ per Zusatzoption `\verb|-c=3|' eingestellt werden.

Wenn Ihnen beim Preview oder Drucken einmal Fonts fehlen, so probieren Sie
doch einfach einmal die Funktion "`Fonts erzeugen"' der \Datei{CTEX}
Shell aus. Die fehlenden Fonts werden dann automatisch erzeugt.

\subsection{Sonstiges}

\TeX\ und Ini\TeX\ k�nnen im Lauf durch Dr�"cken von der \verb|ESCAPE|-Taste
unterbrochen werden. Nach Eingabe von `?' erf�hrt man, was dann weiter
zu machen ist.

Ist in einer Eingabezeile von der {\em Tastatur} das {\em erste} Zeichen ein
Control-D oder Control-Z, so wird die Eingabe beendet und der \TeX-Lauf
hier abgebrochen. Sp�ter in der Zeile haben diese Zeichen keine
Sonderbedeutung mehr. N�tzlich ist dies z.\,B.\ als Notausstieg bei nicht
gefundenen Dateien ('...Please enter file name:').

Die switch-to-editor Option (Eingabe von 'E' nach Fehlermeldung) wird
f�r \TeX\ unterst�tzt.

\subsection{Zu beachten beim Upgrade \TeX\ 2.98
           $\protect\longrightarrow$ \TeX\ 3.*}

Der �bergang von \TeX\ 3.1 auf \TeX\ 3.141 ist v�llig problemlos. Der folgende
Text bezieht sich nur auf den �bergang von Uralt-Versionen.

Normalerweise k�nnen Sie Ihre Texte vom \TeX\ 2.98 // 1.4cs so, wie sie sind,
auf \TeX\ 3.* // 2.*cs �bernehmen. Ein paar Besonderheiten sind aber
doch zu beachten:

\begin{enumerate}
\item In den alten Styles war teilweise '\Datei{DIN_A4.TEX}' schon mit
      eingebunden. Aus Kompatibilit�tsgr�nden wird das jetzt nicht mehr
      gemacht. Schreiben Sie also jetzt z.B.

\begin{verbatim}
      \documentstyle[11pt,din_a4,german]{article}
\end{verbatim}

   statt

\begin{verbatim}
      \documentstyle[11pt,german]{article}
\end{verbatim}

      Mit obiger 'german'-Option kommen jetzt, wie man das auch erwartet, die
      deutschen Texte in den �berschriften usw.

\item Ein 'alter Zopf' wurde nun doch abgeschnitten: Bisher wurden GEM Image
      und MetaFile Bilder bei der Einbindung immer um den Faktor~1.4
      verkleinert. Dieser Faktor hat f�r viel Verwirrung gesorgt, und ich habe
      mich daher entschlossen, ab der DVI-Treiber Version 2.9.60 diesen
      Faktor ersatzlos zu streichen.

      Daher m�ssen Sie nun die Gr��e aller eingebundener GEM Bilder neu
      einstellen.

      Andererseits wurde aber wiederum die GEM Image Einbindung stark
      beschleunigt und verbessert. Die Bilder sehen jetzt bei beliebigen
      Vergr��erungen wesentlich besser aus als bisher.

\item Dies betrifft Sie nur dann, wenn Sie CS-\TeX\ mit einem fremden
      Macro-Paket wie z. B. AMS\TeX\ benutzen wollen: Wie in 'knuth.tex'
      beschrieben, kann \TeX\ 3.0 jetzt Trennmuster f�r mehrere Sprachen
      gleichzeitig einbinden. GERMAN.TEX unterst�tzt dies, und schaltet
      den \verb|\language| Parameter um.

      Daher sind nun in der *.INI-Datei englische Trennmuster vor, deutsche
      jedoch nach der Einbindung von GERMAN.TEX zu laden.

      Schaltet man \TeX\ n�mlich auf eine \verb|\language| um, f�r die keine
      Trennmuster definiert sind, so kann \TeX\ gar nichts mehr trennen, und
      man erh�lt sehr unsch�ne Ergebnisse, viele 'overfull hbox' und
      'underfull hbox'-Warnungen und dergleichen mehr.

\item Bitte benutzen Sie nicht blind fremde Dateien. Die Version~2.3d von
      \verb|GERMAN.TEX| hat z.\,B.\ vielen Leuten �rger bereitet.
      Die beiliegende Version~2.3e funktioniert dagegen einwandfrei.
\end{enumerate}

\subsection{Fehlermeldungen}

Bei der Benutzung des \TeX-Systems k�nnen verschiedene Fehler auftreten.

Etliche Fehlermeldungen stammen aus dem Bereich des Betriebssystems,
wie z.\,B.\ 'disk full'. Halten Sie auf der Disk immer genug Platz frei.

Weitere Fehler sind in `\Datei{fehler.txt}' dokumentiert.

Seien Sie versichert, da� die Beispiele aus dem Ordner `\Datei{DEMO}'
und die `\Datei{.tex}'-Dateien aus dem Ordner `\Datei{TEX_DOC}'
alle ohne �nderung funktionieren. Wenn Sie jedoch an der Installation
herumpfuschen oder die Beispiele manipulieren, kann es allerdings sein,
da� diese dann nicht mehr laufen.

S�mtliche Einstellungen der \Datei{CTEX} Shell sind so vorbelegt, da� Sie
mit dem System sofort arbeiten k�nnen. Die Druckertreiber sind f�r
NEC P6 (180 und 360 dpi), HP LaserJet und PostScript voreingestellt.
Wenn Sie einen anderen Drucker benutzen wollen, m�ssen Sie den entsprechenden
Druckertreiber einstellen und die Zusatzparameter daf�r nach Ihren W�nschen
anpassen.

Sollten Sie Probleme haben (gar nichts funktioniert mehr), so l�schen Sie
einfach \Datei{CTEX.INF}. Dann sind wieder die (funktionierenden)
Standard-Einstellungen aktiv.

Fehler suche man zun�chst bei sich selber. Haben die Programme
tats�chlich noch Fehler, so k�nnen Sie mir eine kurze Beschreibung
des Fehlers (1/2 Seite) zukommen lassen, die ich dann evtl. gelegentlich
pr�fen werde. Lesen Sie bitte auch `Fehler.txt'.

Wenn Sie mir schreiben wollen, vergessen Sie nicht, R�ckporto beizulegen.
Und bedenken Sie bitte, da� Sie f�r kostenlose Software keinen Service,
keine Beratung, usw.\ verlangen k�nnen. Wenn Sie Service wollen, sollten Sie
lieber eine kommerzielle \TeX-Version (wie beispielsweise Multi\TeX~5.0)
benutzen.

Beachten Sie bitte auch, da� sich vermutlich demn�chst meine Adresse �ndert.
N�heres sehen Sie in \Datei{DVI_DOC.DVI}, der Dokumentation zu den
\Datei{DVI}-Treibern.

%
%%%%%%%%%%%% Ende %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\end{document}
